home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1997 February / JCSM Shareware Collection February 1997 Best of (JCS Marketing)(February 1997).bin / SCI_MATH / METRIC67.ZIP / CLIPPER.DOC next >
Text File  |  1995-02-10  |  19KB  |  480 lines
  1.  
  2.  
  3.                   CLIPPER
  4.                 Version 2.00
  5.                The MetriCon Clipboard Utility
  6.  
  7.              Copyright (c) 1994 Harold Schwartz
  8.  
  9.  
  10.  
  11.                 ALL RIGHTS RESERVED
  12.  
  13.                 Harold Schwartz
  14.                 P.O. Box 104482
  15.                 Jefferson City, MO  65110
  16.  
  17.  
  18.                 Welcome to Clipper!!!
  19.  
  20.  
  21.  
  22. CLIPPER has one use, and that is to allow users of MetriCon, the Unit Con-
  23. version software, to paste the results of conversions into an underlying
  24. word-processor or editor.  MetriCon is DOS based software and, as is the
  25. case with most DOS software, it does not afford the user any method of
  26. easily transferring the output of the program to another DOS program.  This
  27. program addresses this problem by offering the user of MetriCon this option
  28. in the form of a resident 'clipboard', much as the clipboard used in Windows.
  29. Note that CLIPPER is useful only to users of MetriCon.
  30.  
  31.  
  32. What is included in the CLIPPER package?...
  33.  
  34.     There are only two files that can be considered as a part of the
  35.     CLIPPER software.  They are:
  36.  
  37.                 CLIPPER.EXE
  38.                 CLIPPER.DOC
  39.  
  40.     These files are not distributed as a stand-alone package, but
  41.     rather are included as part of the MetriCon software package.
  42.  
  43.  
  44. Is CLIPPER free software?...
  45.  
  46.     No, CLIPPER is not free.  It is sold only as a part of the
  47.     MetriCon software package.  MetriCon is a very affordable
  48.     unit conversion program capable of  making in excess of
  49.     30,000 different unit conversion.  MetriCon specializes in
  50.     conversion to/from the metric system of measurement.
  51.  
  52.  
  53. How does CLIPPER work?...
  54.  
  55.     CLIPPER is a TSR (Terminate Stay Resident) program.  A TSR is
  56.     a program that will stay in DOS memory, even while you are
  57.     running other DOS software, such as MetriCon.  While MetriCon
  58.  
  59.  
  60.  
  61.                                     Page 2
  62.  
  63.  
  64.     is running and after you have made a unit conversion, CLIPPER
  65.     will 'copy' the result of the conversion to the clipboard if
  66.     you press a Hot-Key.  Then, when you quit MetriCon and enter
  67.     your editor or word-processor, pressing another Hot-Key causes
  68.     CLIPPER to 'paste' the result of the conversion into the editor
  69.     or word-processor at the location of the cursor. Each time you
  70.     copy a conversion to CLIPPER's clipboard the clipboard is
  71.     cleared of the result of the previous conversion.
  72.  
  73.  
  74. What part of the converted value is pasted to the editor?...
  75.  
  76.     When the 'copy' HotKey is pressed, the mathematical value of the
  77.     conversion as well as the unit description text is copied to the
  78.     clipboard.  In other words, if a conversion yields the result
  79.  
  80.             1.046457E-002 metre (m)
  81.  
  82.     that entire string is copied to the clipboard and will be subse-
  83.     quently pasted to the editor.  Once pasted in, it is the user's
  84.     responsibility to format the information to a suitable form.
  85.     Note that no matter what exponential option is selected in the
  86.     MetriCon program ( 'E' notation or '10' notation ), the result
  87.     that is pasted will be in 'E' notation format.  The reason is
  88.     that most word-processors and printers cannot reproduce the
  89.     small characters used in the '10' notation, for example, as in
  90.     2.5 x 10².  Whichever way the result is displayed in the STANDARD
  91.     CONVERSION window, it will be pasted in the 'E' notation format.
  92.  
  93.  
  94. How do I install CLIPPER?...
  95.  
  96.     When you install MetriCon, CLIPPER will be installed into the
  97.     same directory that MetriCon is installed to.  Whenever you
  98.     want to use MetriCon and you want the capability of transferring
  99.     conversions into your word processor document, just run CLIPPER
  100.     first to install it into memory.  Once CLIPPER is in memory you
  101.     may use MetriCon as you normally would to make a conversion.
  102.     After the conversion has been calculated and is being displayed
  103.     in the "STANDARD CONVERSION" window, simply press the 'copy'
  104.     Hot-Key to copy the conversion to the clipboard in CLIPPER.  Then,
  105.     when you exit MetriCon and load a document into your word-process-
  106.     ing program, the converted value can be pasted into the document
  107.     at the cursor location by pressing the 'paste' Hot-Key.
  108.  
  109.  
  110. How do I know if CLIPPER is installed?...
  111.  
  112.     At the time CLIPPER is installed the user is informed of the swap
  113.     location that the program is using.  At any time after CLIPPER is
  114.     installed, you can verify that it is in memory by pressing the
  115.     'copy to clipboard' HotKey.  Each time this HotKey is pressed a
  116.  
  117.  
  118.  
  119.                                     Page 3
  120.  
  121.  
  122.     high-pitched beep occurs and is a good indication that CLIPPER is
  123.     in memory.  Each time the 'paste from clipboard' HotKey is pressed
  124.     a lower-pitched beep sounds, also.
  125.  
  126.  
  127. How much memory does CLIPPER use?...
  128.  
  129.     CLIPPER is designed to use as little low DOS memory as possible.
  130.     In order to do this, it must swap most of its code out of memory
  131.     when it installs.  It does this by swapping to one of three diff-
  132.     erent location, either expanded memrory (EMS), extended memery
  133.     (XMS), or to a pair of files on the C-drive called CLIPPER.SW1
  134.     and CLIPPER.SW2.  CLIPPER will first try to swap to EMS memory.
  135.     If you don't have EMS memory or you don't have enough free EMS
  136.     memory, it will try to swap to your C-drive.  If you want CLIPPER
  137.     to swap to XMS memory, you must 'tell' it to do so by using the
  138.     /X command-line option as explained below.  Once CLIPPER swaps
  139.     out of memory it uses only about 8K of low DOS RAM.
  140.  
  141.  
  142. Can I remove CLIPPER from memory?...
  143.  
  144.     Yes.  If CLIPPER is installed in memory it can be uninstalled by
  145.     running it again with the /U command-line option.  When run in
  146.     this manner, CLIPPER will remove itself from memory provided no
  147.     TSR's have been loaded after CLIPPER.  If you load another TSR
  148.     after CLIPPER is in memory, you must remove the TSR from memory
  149.     before uninstalling CLIPPER.
  150.  
  151.  
  152. What are the command-line options for running CLIPPER>...
  153.  
  154.     There are a number of command-line options that may be used to con-
  155.     figure CLIPPER the way you want when you install it to memory.
  156.     Below is a list of the command-line options available and an
  157.     explanation of their use.
  158.  
  159.  
  160.      /A         Use normal file attribute for swap file (instead of hidden).
  161.      /C HotKey  Specify alternate hot key for copy to clipboard.
  162.      /D         Force swapping to disk even if EMS is available.
  163.      /M         Disable message appearing while TSR swaps to or from disk.
  164.      /N         Force entire TSR to remain in memory (no swapping).
  165.      /P HotKey  Specify alternate hot key for paste from clipboard.
  166.      /S Path    Specify drive and directory for disk swapping.
  167.      /W         Disables 'beep' on copy or paste operation.
  168.      /X         Use XMS memory if available.
  169.      /1         Single swap file (for RAM disks or XMS).
  170.      /U         Unload TSR from memory.
  171.      /?
  172.  
  173.  
  174.  
  175.                                     Page 4
  176.  
  177.  
  178.      /A - If you have no expanded memory (EMS) or extended memory (XMS) on
  179.       your system, CLIPPER will swap most of itself to your hard drive
  180.       when it installs.  In this way it is able to use a very small
  181.       amount of low DOS RAM (about 8K).  The files on your hard drive
  182.       that CLIPPER creates for swapping are named CLIPPER.SW1 and
  183.       CLIPPER.SW2.  They have the 'hidden' system attribute set by
  184.       default so that they won't be inadvertently deleted while ClIPPER
  185.       is running.  If you do not want these files to have the 'hidden'
  186.       attribute set, you may use start CLIPPER with the /A command-line
  187.       option.  (Note that when CLIPPER is uninstalled, it automatically
  188.       deletes these swap files.)
  189.  
  190.  
  191.      /C HotKey - If the default HotKey conflicts with a HotKey already in
  192.          use on your system, this option can be used to specify a
  193.          different 'copy' HotKey to copy conversions to the clip-
  194.          board.  Listed in the section below are some of the many
  195.          HotKeys that may be specified.  For instance, the command
  196.  
  197.                  CLIPPER /C 040E
  198.  
  199.          would specify to start CLIPPER with the <Ctrl><Backspace>
  200.          HotKey activated to copy data to the clipboard.  The sec-
  201.          tion below explains more about selecting HotKey codes.
  202.          Note that there MUST be a space between the 'C' and the
  203.          beginning of the HotKey code.
  204.  
  205.  
  206.      /D - If you wish to force CLIPPER to use the hard drive for the swap
  207.       location even if you have EMS memory on your system, use this
  208.       command-line option.
  209.  
  210.  
  211.      /M - When CLIPPER is activated by either HotKey, if it is using a swap
  212.       file on the hard drive, it will display a swapping message as it
  213.       swaps into and out of memory.  This swapping message will appear
  214.       on the top or bottom line of your display very briefly.  On very
  215.       fast systems, with fast hard drives, it may be barely visible.  If
  216.       you do not want this message to display, it may be deactivated by
  217.       using this command-line option.
  218.  
  219.  
  220.      /N - If for some reason you do not want CLIPPER to swap to EMS or XMS
  221.       memory or to hard drive, you may use this command-line option to
  222.       force the entire program to remain in memory.  If you use this
  223.       option, be aware that CLIPPER will take a considerable of memory
  224.       and may not leave enough room to run other programs at the same
  225.       time.
  226.  
  227.  
  228.      /P HotKey - If the default HotKey conflicts with a HotKey already in
  229.          use on your system, this option can be used to specify a
  230.          different 'paste' HotKey to paste conversions from the
  231.  
  232.  
  233.  
  234.                                     Page 5
  235.  
  236.  
  237.          clipboard to your editor or word-processor.  Listed in the
  238.          section below are some of the many HotKeys that may be
  239.          specified.  For instance, the command
  240.  
  241.                  CLIPPER /P 040E
  242.  
  243.          would specify to start CLIPPER with the <Ctrl><Backspace>
  244.          HotKey activated to paste data from the clipboard.  The
  245.          section below explains more about selecting HotKey codes.
  246.          Note that there MUST be a space between the 'C' and the
  247.          beginning of the HotKey code.
  248.  
  249.  
  250.      /S Path - By default CLIPPER will create its swap files in the root
  251.            directory of your C-drive.  If you want CLIPPER to use a
  252.            different location, use this command-line option to
  253.            specify the location.  For instance,
  254.  
  255.                    CLIPPER /S C:\METRIC
  256.  
  257.            would tell CLIPPER to use the METRIC directory location
  258.            for creating its swap files (that is, if it is using swap
  259.            files rather than EMS or XMS memory for the swap location).
  260.  
  261.  
  262.      /W - Normally CLIPPER emits a high-pitched beep each time the 'copy'
  263.       HotKey is pressed and emits a low-pitched beep each time the
  264.       'paste' HotKey is pressed.  If you do not want CLIPPER to beep
  265.       each time a HotKey is pressed, use this command-line option.
  266.  
  267.  
  268.      /X - If your system has XMS memory available you may 'tell' CLIPPER
  269.       to use the XMS memory for the swap location.  CLIPPER will use
  270.       XMS memory only if configured to do so by using the /X command-
  271.       line option.
  272.  
  273.  
  274.      /1 - Specifies that CLIPPER use only one swap file rather than two if
  275.       it is using a ram or XMS memory for a swap location.  This will
  276.       conserve memory.
  277.  
  278.  
  279.      /U - Provided CLIPPER has been installed into memory, the /U command-
  280.       line option will 'tell' CLIPPER to uninstall itself.  If you have
  281.       installed another TSR after CLIPPER was installed, CLIPPER will
  282.       respond that it cannot be unloaded.
  283.  
  284.      /? - Shows a two-page help screen that briefly explains how to install
  285.       CLIPPER and what the command-line options are.
  286.  
  287.  
  288.  
  289.                                     Page 6
  290.  
  291.  
  292.      These command-line options may be used singly or in combination.  Be
  293.      aware that the /C, /P, and /S options MUST be used with a space
  294.      between the option letter and the HotKey code. For example, the
  295.      command
  296.  
  297.             CLIPPER /C 040E /P 0C51 /X
  298.  
  299.      would load CLIPPER into memory with swapping to XMS memory, with the
  300.  
  301.  
  302.      'copy to clipboard' HotKey configured as <Ctrl><Backspace>, and with
  303.      the 'paste from clipboard' configured as <Ctrl><Alt><Pg Down>.  Note
  304.      that the /C and /P options have a space after the command-line desig-
  305.      nator.
  306.  
  307.  
  308. What are the Hot-Keys used in CLIPPER?...
  309.  
  310.     There are two default Hot-Keys for the CLIPPER program.  They are:
  311.  
  312.         <Left Shift><F1>  to copy a conversion to the clipboard.
  313.         <Left Shift><F2>  to paste a conversion to a document.
  314.  
  315.     There may be times when these Hot-Keys may conflict with a Hot-Key
  316.     that is already used by the editor or word-processor that you are
  317.     using.  If this is the case, you must change one or both Hot-Keys
  318.     before you use CLIPPER.  This is done by starting CLIPPER with one
  319.     or both of the appropriate command-line options as discussed in the
  320.     previous section.  There are many possibilities for the selection
  321.     of the Hot-Keys.  The following listing gives some:
  322.  
  323.  
  324.  
  325.                 HOT-KEY CODES
  326.  
  327.  
  328.            <Ctrl><=> : 040D               <Ctrl><Alt><F1> : 0C3B
  329.            <Ctrl><-> : 040C               <Ctrl><Alt><F2> : 0C3C
  330.           <Alt><F11> : 0857              <Ctrl><Alt><F11> : 0C57
  331.           <Alt><F12> : 0858              <Ctrl><Alt><F12> : 0C58
  332.           <Alt><End> : 084F               <Ctrl><Alt><F3> : 0C3D
  333.          <Alt><Home> : 0847               <Ctrl><Alt><F4> : 0C3E
  334.        <Alt><Insert> : 0852             <Alt><Rt Shft><&> : 0908
  335.         <Alt><Pg Up> : 0849            <Alt><Lft Shft><%> : 0A06
  336.       <Alt><Pg Down> : 0851             <Alt><Rt Shft><@> : 0903
  337.     <Ctrl><Rt Arrow> : 044D            <Alt><Lft Shft><^> : 0A07
  338.     <Ctrl><Lt Arrow> : 044B            <Alt><Lft Shft><$> : 0A05
  339.      <Alt><Up Arrow> : 0848            <Ctrl><Rt Shft><#> : 0504
  340.        <Alt><Down Arrow> : 0850           <Ctrl><Lft Shft><!> : 0602
  341.        <Alt><Lt Shft><}> : 0A1B            <Ctrl><Rt Shft><{> : 051A
  342.  
  343.  
  344.  
  345.                                     Page 7
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.     Additional HotKey codes are given on the help screens.
  353.  
  354.     A HotKey is specified as a hexadecimal word. The top byte specifies
  355.     the shift key(s) to be pressed and can be zero. The bottom byte
  356.     specifies the scan code for the hot key. Two hot keys may not have
  357.     the same scan code, even if the shift code differs.
  358.  
  359.     The shift key codes are: Alt:08, Ctrl:04, Left Shift:02, Right
  360.     Shift:01. These codes give you the value for the high byte of the
  361.     HotKey code.  The scan code for the other key used for the HotKey
  362.     code is used as the low byte.  For example: 0844 performs lookup
  363.     when <Alt><F10> is pressed.  The code for <Alt> which is 08 plus
  364.     the scan code for <F10> which is 44.  If you want to specify a
  365.     combination of two shift keys for the high byte, you would add the
  366.     scan codes for the two shift keys to get the high byte.  For ex-
  367.     ample, <Ctrl><Left Shift> would be 04 + 02 = 06.  Remember that
  368.     the scan codes are hexadecimal numbers and must be added with hex-
  369.     adecimal arithmetic.  Actually, there are already ample HotKey
  370.     codes shown above and it is doubtful that one could not be selected
  371.     for any application.
  372.  
  373.  
  374. Is help available when using CLIPPER?...
  375.  
  376.     There are two help screen available and can be accessed from the
  377.     command-line with the command
  378.  
  379.                 CLIPPER /?
  380.  
  381.     These help screen describe how to install CLIPPER and show the
  382.     various command-line options available.
  383.  
  384.  
  385. Is CLIPPER compatible with Microsoft Windows?...
  386.  
  387.     CLIPPER cannot be used to transfer information between programs
  388.     in Windows that are running in separate windows.  It can be used
  389.     however, to transfer converted results between programs that are
  390.     run in the same window.
  391.  
  392.     There is a way to transfer the converted values from MetriCon to
  393.     a windows application. Run MetriCon in a window.  You can do that
  394.     with Windows' DOS prompt by hitting <Alt><Enter> during the DOS
  395.     session.  You can also use the Windows program information file
  396.     (PIF) Editor to change MetriCon's application information, desig-
  397.     nating the display as 'Windowed'.  While MetriCon is running as
  398.     a Window and the result of a conversion is displayed in the
  399.     Standard Conversion window, click on the control bar and select
  400.  
  401.  
  402.  
  403.                                     Page 8
  404.  
  405.  
  406.     Edit, Mark.  Using the mouse, block-mark the converted value
  407.     (including the text portion, if you wish), and again select
  408.     Edit, Copy to copy the marked text to the clipboard.  Then, enter
  409.     the Window's application and use the Edit, Paste command to copy
  410.     the contents of the clipboard to the cursor location.
  411.  
  412.  
  413. Is CLIPPER compatible with earlier versions of MetriCon?...
  414.  
  415.     Yes, CLIPPER is compatible with all versions of MetriCon through
  416.     version 6.0.
  417.  
  418.  
  419.             Thanks and ***ENJOY*** MetriCon.
  420.  
  421. --Acknowledgements...
  422.  
  423.     In this documentation, references are made to several
  424.     products:
  425.  
  426.     DOS refers to either PC-DOS or MS-DOS.
  427.     PC-DOS is a registered trademark of International Business
  428.     Machines Corporation.
  429.     MS-DOS and Windows are registered trademarks of Microsoft
  430.     Corporation.
  431.  
  432.                ***** DISCLAIMER *****
  433.  
  434.                    (please  read)
  435.  
  436.         "CLIPPER" is a powerful program.  While I have
  437.         attempted to build in reasonable safeguards, as with
  438.         any useful computer software, "CLIPPER" may contain
  439.         errors in the program or documentation.  The author
  440.         does not give any warranty, either expressed or
  441.         implied, to anyone using this program other than for
  442.         the replacement of defective media.  In no event shall
  443.         the author be liable for any damages, including loss
  444.         of profits or anticipated profits, lost savings, or
  445.         other incidental or consequential damages arising out
  446.         of the use or inability to use this program.  The
  447.         program comes "as is" and it is the user's responsi-
  448.         bility to determine whether the program is suitable
  449.         for his or her computer system and software needs.
  450.  
  451.  
  452.  
  453.                                     Page 9
  454.  
  455.  
  456.                ***** COPYRIGHT *****
  457.  
  458.  
  459.        Copyright (c) 1994 by Harold Schwartz.   All Rights
  460.        Reserved.  You may copy "CLIPPER" for backup purposes,
  461.        and you may give copies of the unregistered version to
  462.        other individuals, which they may also use and copy
  463.        under the terms of this agreement.  If you copy the
  464.        unregistered version of "CLIPPER" for others, you must
  465.        include all of the files distributed with it. MetriCon
  466.        may not be sold, licensed, or a fee charged for its use.
  467.        If a fee is charged in connection with the unregistered
  468.        version of "CLIPPER", it must cover the cost of copying
  469.        or dissemination only.  Such charges must be clearly
  470.        identified as such by the originating party.  Under no
  471.        circumstances may the purchaser be given the impression
  472.        that he is buying "CLIPPER" itself.
  473.  
  474.        The author encourages BBS operators to post the unregis-
  475.        tered version of the MetriCon package on their systems
  476.        for download by users wishing to evaluate it.  No other
  477.        reproduction or use is authorized without the express
  478.        prior written consent of the copyright owner.
  479.  
  480.